home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / proboard / doing112.zip / DOINGSDK.TXT < prev    next >
Text File  |  1996-04-25  |  3KB  |  87 lines
  1.   / | _ | \______________
  2.  /         \             \                                            
  3. (   o   o   )         /   |
  4.  \  _| |_  /        _(__   \______                                
  5. ┌ =(_/v\_)=__)_____(______\_______)─────────────────────────────────────────┐
  6. │ SDK for making your PEXs & EXEs DOING Compatible (C)1996 Fe-line Software │
  7. │ Written by Faye Pearson, Docs by Sarah Pearson          (24th April 1996) │
  8. └───────────────────────────────────────────────────────────────────────────┘
  9.  
  10. Doing comes with a C ".h" file to allow programmers to easily incorporate
  11. DOING support into pexs and now EXEs.
  12.  
  13. All that needs to be done, is to #include "doing.h" after the
  14. #include "pb_sdk.h" line.  
  15.  
  16. This is so that Doing.h can detect you are compiling a PEX and include the
  17. relevant code, otherwise it will think it is an EXE and you will get errors.
  18.  
  19. Whenever you want to set the DOING description to something else, just
  20. use SetDesc().
  21.  
  22. ---> If you have compiled any PEXs or EXEs with doing support, then a simple
  23.      recompile with the enclosed DOING.H will install the OS/2 Support.
  24.  
  25. ---
  26. bool SetDesc(char*Description);
  27.  
  28. Description: The string you wish DOING to display.
  29.  
  30. Returns: TRUE if the file was successfully updated.
  31.          FALSE if there was an error.
  32.  
  33.  
  34. eg.
  35.  
  36. #include "pb_sdk.h"
  37. #include "doing.h"
  38.  
  39. void main()
  40. {
  41.         SetDesc("In Demo Part 1");
  42.         printf("\nPress ENTER to continue\n");
  43.         WaitKey();
  44.         SetDesc("In Demo Part 2");
  45.         printf("Press ENTER to finish\n");
  46.         SetDesc("");
  47. }
  48. ---
  49.  
  50. YOU MUST REMEMBER:
  51.  
  52. Put a SetDesc("") in before your program ends otherwise it will continue to
  53. display whatever you set until the next DOING compatible pex is used.
  54.  
  55. It is possible to display a DOING message when the node is idle, but you
  56. must add "\xfe\xff" to the start of the doing string:
  57.  
  58. eg.
  59.  
  60.      SetDesc("\xfe\xffI'm having a nap.");
  61.  
  62. This is so that ordinary doing messages do not remain when the user hangs up
  63. or logs off.
  64.  
  65. All we ask if you do use DOING.H is that in every archive containing a DOING
  66. compatible PEX or EXE you include DOING.TXT.
  67.  
  68. -----------------------------------------------------------------------------
  69.  
  70. This DOING SDK PEX Kit is supplied "as is" and we will not be held responsible
  71. for any damage caused by this SDK.  It works on our BBS ok, so that is the
  72. only guarantee given :-)
  73.  
  74.  
  75. --
  76. Sarah & Faye, sysops@fe-line.demon.co.uk           Home of Fe-line Software
  77. http://www.win-uk.net/~fe-line       ftp://ftp.win-uk.net/pub/users/fe-line
  78. ProBoard *UK* Registration and Support Site              ProBoard Beta Team
  79. TGPBN Net Coordinators                        PSN *UK* Regional Coordinator
  80.  
  81. ┌───────────────────────────────────────────────────────────────────────────┐
  82. │               We can be reached on the following Node Numbers.            │
  83. │  (2:254/278 Fido / 311:21/0 PSN / 173:902/300 DqP-Net / 752:752/0 TGPBN)  │
  84. │                     sysops@fe-line.demon.co.uk / Internet                 │
  85. └───────────────────────────────────────────────────────────────────────────┘
  86.  
  87.